Incremental Authorization

• Hotel bookings
• Car rentals
• Any service where the final charge may vary

​

✅ Why Use Incremental Authorization?

​

⚠️ Prerequisites

• Your business must operate outside Strong Customer Authentication (SCA) regions.
• Supported only for card payments and specific networks/connectors.
• Check connector-specific documentation to confirm support.

​

🛠️ How to Use Incremental Authorization

​

🧩 Step 1: Enable during payment creation

curl --request POST \
  --url https://api.test.switch.vaultera.co/payments \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
    "amount": 6540,
    "authentication_type": "three_ds",
    "currency": "USD",
    "request_incremental_authorization": true
}'

​

🔍 Step 2: Check if allowed

"incremental_authorization_allowed": true

​

➕ Step 3: Make an incremental authorization request

curl --request POST \
  --url https://api.test.switch.vaultera.co/payments/{payment_id}/incremental_authorization \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
    "amount": 6540,
    "reason": "Extended stay"
}'

Replace {payment_id} with your actual payment ID and provide a meaningful reason.

​

📌 Notes

• Each incremental authorization must follow the initial authorization.
• The cumulative amount across authorizations cannot exceed network or connector limits.
• All charges will be captured together during final capture.